home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / ftn / getgde.z / getgde
Encoding:
Text File  |  1998-10-20  |  19.5 KB  |  463 lines

  1.  
  2.  
  3.  
  4. ggggeeeettttggggddddeeee((((3333GGGG))))                                                          ggggeeeettttggggddddeeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggeeeettttggggddddeeee - gets graphics system description
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      iiiinnnntttteeeeggggeeeerrrr****4444 ffffuuuunnnnccccttttiiiioooonnnn ggggeeeettttggggddddeeee((((iiiinnnnqqqquuuuiiiirrrr))))
  13.      iiiinnnntttteeeeggggeeeerrrr****4444 iiiinnnnqqqquuuuiiiirrrr
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _i_n_q_u_i_r_y   is a symbolic constant taken from the list below.  It
  17.                identifies the characteristic about which you want to inquire.
  18.  
  19. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  20.      The function returns the value of the requested characteristic, or -1, if
  21.      the request is invalid or its value cannot be determined.
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      ggggeeeettttggggddddeeee allows you to inquire about characteristics of the currently
  25.      selected screen.  If the inquired characteristic is about bitplane
  26.      configuration, ggggeeeettttggggddddeeee will return a value that indicates the absolute
  27.      maximum resources available for the individual characteristic. It is not
  28.      guaranteed that the bitplane configuration will reflect these values, as
  29.      ggggccccoooonnnnffffiiii reconciles the various requests for resources. You must call
  30.      ggggeeeettttggggccccoooo to find out the result of the compromises made by ggggccccoooonnnnffffiiii....  You can
  31.      call ggggeeeettttggggddddeeee prior to graphics initialization, as its return values are
  32.      unaltered by any commands issued after initialization.
  33.  
  34.      The symbolic names of the inquiries and their meanings are specified
  35.      below:
  36.  
  37.    SSSSccccrrrreeeeeeeennnn BBBBoooouuuunnnnddddaaaarrrryyyy IIIInnnnqqqquuuuiiiirrrriiiieeeessss
  38.      GGGGDDDDXXXXMMMMMMMMAAAA
  39.      GGGGDDDDYYYYMMMMMMMMAAAA
  40.           Vertical and horizontal size of the screen in millimeters.
  41.  
  42.      GGGGDDDDXXXXPPPPMMMMAAAA
  43.      GGGGDDDDYYYYPPPPMMMMAAAA
  44.           Vertical and horizontal size of the screen in pixels.
  45.  
  46.      GGGGDDDDZZZZMMMMAAAAXXXX
  47.      GGGGDDDDZZZZMMMMIIIINNNN
  48.           Maximum and minimum depth values that can be stored in the z-buffer
  49.           of the normal framebuffer.
  50.  
  51.    FFFFrrrraaaammmmeeeebbbbuuuuffffffffeeeerrrr DDDDeeeepppptttthhhh IIIInnnnqqqquuuuiiiirrrriiiieeeessss
  52.      GGGGDDDDBBBBIIIIAAAACCCC
  53.           Maximum number of bitplanes per color component in the hardware
  54.           accumulation buffer, if one exists.  Otherwise the number of
  55.           bitplanes per color component in the software version of the
  56.           accumulation buffer, if it is implemented.  Otherwise 0.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggeeeettttggggddddeeee((((3333GGGG))))                                                          ggggeeeettttggggddddeeee((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      GGGGDDDDBBBBIIIIAAAAHHHH
  75.           Maximum number of bitplanes per color component in the hardware
  76.           accumulation buffer, if one exists.  Otherwise 0.
  77.  
  78.      GGGGDDDDBBBBCCCCUUUURRRR
  79.           Number of bitplanes available in the cursor.
  80.  
  81.      GGGGDDDDBBBBNNNNDDDDAAAA
  82.           Maximum number of bitplanes available in the normal framebuffer to
  83.           store alpha in double buffered RGB mode.
  84.  
  85.      GGGGDDDDBBBBNNNNDDDDCCCC
  86.           Maximum number of bitplanes available in the normal framebuffer to
  87.           store the color index in double buffered color map mode.
  88.  
  89.      GGGGDDDDBBBBNNNNDDDDMMMM
  90.           Maximum number of bitplanes available in the normal framebuffer to
  91.           store the color index in double buffered multimap mode.
  92.  
  93.      GGGGDDDDBBBBNNNNDDDDRRRR
  94.      GGGGDDDDBBBBNNNNDDDDGGGG
  95.      GGGGDDDDBBBBNNNNDDDDBBBB
  96.           Maximum number of bitplanes available in the normal framebuffer to
  97.           store red, green, and blue in double buffered RGB mode.  If any of
  98.           these are 0, then double buffered RGB mode is not available.
  99.  
  100.      GGGGDDDDBBBBNNNNSSSSAAAA
  101.           Maximum number of bitplanes available in the normal framebuffer to
  102.           store alpha in single buffered RGB mode.
  103.  
  104.      GGGGDDDDBBBBNNNNSSSSCCCC
  105.           Maximum number of bitplanes available in the normal framebuffer to
  106.           store the color index in single buffered color map mode.
  107.  
  108.      GGGGDDDDBBBBNNNNSSSSMMMM
  109.           Maximum number of bitplanes available in the normal framebuffer to
  110.           store the color index in single buffered multimap mode.
  111.  
  112.      GGGGDDDDBBBBNNNNSSSSRRRR
  113.      GGGGDDDDBBBBNNNNSSSSGGGG
  114.      GGGGDDDDBBBBNNNNSSSSBBBB
  115.           Maximum number of bitplanes available in the normal framebuffer to
  116.           store red, green, and blue in single buffered RGB mode.  If any of
  117.           these are 0, then single buffered RGB mode is not available.
  118.  
  119.      GGGGDDDDBBBBNNNNZZZZBBBB
  120.           Maximum number of useful bitplanes in the z-buffer of the normal
  121.           framebuffer, If 0, then there is no z-buffer.
  122.  
  123.      GGGGDDDDBBBBOOOOSSSSCCCC
  124.           Maximum number of bitplanes available in the overlay framebuffer to
  125.           store the color index in single buffered color map mode.
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ggggeeeettttggggddddeeee((((3333GGGG))))                                                          ggggeeeettttggggddddeeee((((3333GGGG))))
  137.  
  138.  
  139.  
  140.      GGGGDDDDBBBBPPPPSSSSCCCC
  141.           Maximum number of bitplanes available in the popup framebuffer to
  142.           store the color index in single buffered color map mode.
  143.  
  144.      GGGGDDDDBBBBIIIISSSSTTTT
  145.           Maximum number of bitplanes available in the normal framebuffer for
  146.           use as stencil bitplanes.  0 if sssstttteeeennnncccciiii is not functional.
  147.  
  148.      GGGGDDDDBBBBUUUUSSSSCCCC
  149.           Maximum number of bitplanes available in the underlay framebuffer to
  150.           store the color index in single buffered color map mode.
  151.  
  152.    MMMMiiiisssscccceeeellllllllaaaannnneeeeoooouuuussss IIIInnnnqqqquuuuiiiirrrriiiieeeessss
  153.      GGGGDDDDAAAAFFFFUUUUNNNN
  154.           1 if aaaaffffuuuunnnncccctttt is functional, 0 if it is not.
  155.  
  156.      GGGGDDDDAAAAFFFFMMMMOOOO
  157.           1 if all aaaaffffuuuunnnncccctttt functions are supported, 0 if they are not.
  158.  
  159.      GGGGDDDDAAAALLLLPPPPHHHH
  160.           1 if alpha bitplanes in the normal framebuffer can be allocated as
  161.           color map bitplanes in the overlay or underlay framebuffers, 0 if
  162.           they cannot.
  163.  
  164.      GGGGDDDDBBBBLLLLEEEENNNN
  165.           1 if blending is supported in all framebuffers that support RGB
  166.           mode, 0 otherwise.  (See bbbblllleeeennnnddddffff.)
  167.  
  168.      GGGGDDDDBBBBLLLLCCCCOOOO
  169.           1 if bbbblllleeeennnnddddcccc is supported in all framebuffers that support RGB mode,
  170.           0 otherwise.
  171.  
  172.      GGGGDDDDCCCCIIIIFFFFRRRR
  173.           1 if fractional interpolation of color indices is supported in all
  174.           framebuffers, 0 otherwise.  (See ccccoooolllloooorrrrffff.)
  175.  
  176.      GGGGDDDDCCCCLLLLIIIIPPPP
  177.           Number of user-defined clipping planes supported.  0 if none are
  178.           supported.  (See cccclllliiiippppppppllll.)
  179.  
  180.      GGGGDDDDXXXXHHHHCCCCIIII
  181.           Color index whose color map entry controls the color of the cross-
  182.           hair cursor.
  183.  
  184.      GGGGDDDDMMMMXXXXPPPPSSSS
  185.           Number of other graphics pipes available to be video multiplexed
  186.           with the graphics pipe associated with the current screen.
  187.  
  188.      GGGGDDDDDDDDBBBBBBBBOOOO
  189.           1 if the dial and button box routines are functional, 0 if they are
  190.           not.  Unlike most of the others, this inquiry is independent of the
  191.           currently selected screen.  (See ddddbbbbtttteeeexxxxtttt and sssseeeettttddddbbbbllll.)
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ggggeeeettttggggddddeeee((((3333GGGG))))                                                          ggggeeeettttggggddddeeee((((3333GGGG))))
  203.  
  204.  
  205.  
  206.      GGGGDDDDDDDDIIIITTTTHHHH
  207.           1 if dithering is supported.  0 otherwise.
  208.  
  209.      GGGGDDDDFFFFOOOOGGGGVVVV
  210.           1 if ffffooooggggvvvveeeerrrr supports the per vertex fog modes, namely FFFFGGGGVVVVEEEE, FFFFGGGGVVVVEEEE2222,
  211.           and FFFFGGGGVVVVLLLL.  0 if it does not.
  212.  
  213.      GGGGDDDDFFFFOOOOGGGGPPPP
  214.           1 if ffffooooggggvvvveeeerrrr supports the per pixel fog modes, namely FFFFGGGGPPPPEEEE, FFFFGGGGVVVVPPPP2222,
  215.           and FFFFGGGGPPPPLLLL.  0 if it does not.
  216.  
  217.      GGGGDDDDNNNNAAAATTTTVVVV
  218.           0 if the IrisGL implementation is layered on OpenGL.
  219.  
  220.      GGGGDDDDFFFFRRRRAAAAMMMM
  221.           1 if rrrreeeeaaaaddddssssoooo((((SSSSRRRRCCCCFFFFRRRRAAAA)))) is functional, 0 if it is not.
  222.  
  223.      GGGGDDDDLLLLIIIIAAAA2222
  224.           1 if the AAAATTTTTTTTEEEENNNN2222 lighting model attribute is functional, 0 if it is
  225.           not.  (See llllmmmmddddeeeeffff.)
  226.  
  227.      GGGGDDDDLLLLIIIISSSSPPPP
  228.           1 if spotlights are functional, 0 if they are not.  (See llllmmmmddddeeeeffff.)
  229.  
  230.      GGGGDDDDLLLLIIIITTTTWWWW
  231.           1 if the TTTTWWWWOOOOSSSSIIIIDDDD lighting model attribute is functional, 0 if it is
  232.           not.  (See llllmmmmddddeeeeffff.)
  233.  
  234.      GGGGDDDDLLLLSSSSCCCCMMMM
  235.           1 if antialiased lines are supported in the normal framebuffer in
  236.           color map mode, 0 otherwise.  (See lllliiiinnnneeeessssmmmm.)
  237.  
  238.      GGGGDDDDLLLLSSSSRRRRGGGG
  239.           1 if antialiased lines are supported in RGB mode in all framebuffers
  240.           that support RGB mode, 0 otherwise.  (See lllliiiinnnneeeessssmmmm.)
  241.  
  242.      GGGGDDDDLLLLOOOOGGGGIIII
  243.           1 if logical operations are supported in all framebuffers, 2 if only
  244.           in the normal framebuffer, and 0 otherwise.  (See llllooooggggiiiiccccoooo.)
  245.  
  246.      GGGGDDDDMMMMUUUULLLLTTTT
  247.           1 if the multisample routines are functional, 0 if they are not.
  248.  
  249.      GGGGDDDDNNNNBBBBLLLLIIII
  250.           Maximum number of blinking color map entries on the selected screen.
  251.           If the value is non-zero, it will be at least 20.  (See bbbblllliiiinnnnkkkk.)
  252.  
  253.      GGGGDDDDNNNNMMMMMMMMAAAA
  254.           Number of smaller color maps available to the user in multimap mode.
  255.           On some models, the highest-numbered color map is reserved for use
  256.           by the system.  (See sssseeeettttmmmmaaaapppp.)
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. ggggeeeettttggggddddeeee((((3333GGGG))))                                                          ggggeeeettttggggddddeeee((((3333GGGG))))
  269.  
  270.  
  271.  
  272.      GGGGDDDDNNNNSSSSCCCCRRRR
  273.           Number of screens available on the system.  Unlike most of the
  274.           others, this inquiry is independent of the currently selected
  275.           screen.
  276.  
  277.      GGGGDDDDNNNNUUUURRRRBBBB
  278.           Maximum order of any NURBS surface, NURBS curve, and NURBS trimming
  279.           curve.
  280.  
  281.      GGGGDDDDNNNNVVVVPPPPOOOO
  282.           Maximum number of vertices in a single polygon.  If there is no
  283.           limit, then GGGGDDDDNNNNOOOOLLLLIIII is returned.
  284.  
  285.      GGGGDDDDOOOOVVVVEEEERRRR
  286.           1 if overlay and underlay planes are shared, 0 if both can be used
  287.           simultaneously.
  288.  
  289.      GGGGDDDDPPPPAAAATTTTSSSS
  290.           1 if 64x64 patterns are supported, 0 otherwise.  (See ddddeeeeffffppppaaaatttt.)
  291.  
  292.      GGGGDDDDPPPPSSSSCCCCMMMM
  293.           1 if antialiased points are supported in the normal framebuffer in
  294.           color map mode, 0 otherwise.  (See ppppnnnnttttssssmmmmoooo.)
  295.  
  296.      GGGGDDDDPPPPSSSSRRRRGGGG
  297.           1 if antialiased points are supported in RGB mode in all
  298.           framebuffers that support RGB mode, 0 otherwise.  (See ppppnnnnttttssssmmmmoooo.)
  299.  
  300.      GGGGDDDDPPPPOOOOMMMMOOOO
  301.           1 if ppppoooollllyyyymmmmoooo is functional, 0 if it is not.
  302.  
  303.      GGGGDDDDPPPPOOOOSSSSMMMM
  304.           1 if antialiased polygons are supported in RGB mode in all
  305.           framebuffers that support RGB mode, 0 otherwise.  (See ppppoooollllyyyyssssmmmm.)
  306.  
  307.      GGGGDDDDPPPPUUUUPPPPOOOO
  308.           1 if the popup bitplanes can be allocated as color map bitplanes in
  309.           the overlay or underlay framebuffers, 0 if they cannot.
  310.  
  311.      GGGGDDDDRRRRSSSSRRRRCCCC
  312.           1 if rrrreeeeaaaaddddssssoooo sources SRCAUT, SRCFRO, and SRCBAC are functional, 0 if
  313.           they are not.
  314.  
  315.      GGGGDDDDRRRRSSSSZZZZBBBB
  316.           1 if rrrreeeeaaaaddddssssoooo((((SSSSRRRRCCCCZZZZBBBBUUUU)))) is functional, 0 if it is not.
  317.  
  318.      GGGGDDDDSSSSCCCCRRRRBBBB
  319.           1 if ssssccccrrrrbbbbooooxxxx is functional, 0 if it is not.
  320.  
  321.      GGGGDDDDSSSSTTTTYYYYPPPP
  322.           Type of the currently selected screen.  Returns GGGGDDDDSSSSTTTTWWWWMMMM if there is
  323.           window management on the screen or GGGGDDDDSSSSTTTTNNNNWWWW if there isn't.  There can
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. ggggeeeettttggggddddeeee((((3333GGGG))))                                                          ggggeeeettttggggddddeeee((((3333GGGG))))
  335.  
  336.  
  337.  
  338.           be at most one window open on screens of the latter type.
  339.  
  340.      GGGGDDDDSSSSTTTTEEEERRRR
  341.           1 if sssseeeettttmmmmoooonnnn((((SSSSTTTTRRRRRRRREEEECCCC)))) is functional, 0 if it is not.
  342.  
  343.      GGGGDDDDSSSSTTTTIIIIWWWW
  344.           1 if per-window stereo is functional, 0 if it is not.  (See sssstttteeeerrrreeeeoooo.)
  345.  
  346.      GGGGDDDDSSSSBBBBLLLLIIII
  347.      GGGGDDDDSSSSBBBBPPPPNNNN
  348.      GGGGDDDDSSSSBBBBPPPPOOOO
  349.           1 if subpixel positioned lines, points, and polygons (respectively)
  350.           are supported in all framebuffers, 0 otherwise.  (See ssssuuuubbbbppppiiiixxxx.)
  351.  
  352.      GGGGDDDDTTTTEEEEXXXXTTTT
  353.           1 if the textport routines are functional, 0 if they are not.
  354.           Unlike most of the others, this inquiry is independent of the
  355.           currently selected screen.  (See tttteeeexxxxttttppppoooo.)
  356.  
  357.      GGGGDDDDTTTTXXXXTTTTRRRR
  358.           1 if texture mapping routines are functional, 0 if they are not.
  359.           (See tttteeeexxxxddddffff2222.)
  360.  
  361.      GGGGDDDDTTTTXXXX3333DDDD
  362.           1 if 3D texture mapping routines are functional, 0 if they are not.
  363.           (See tttteeeexxxxddddffff3333.)
  364.  
  365.      GGGGDDDDTTTTXXXXDDDDEEEE
  366.           1 if TTTTXXXXDDDDEEEETTTTAAAA is functional, 0 if it is not.  (See tttteeeexxxxddddeeeeffff.)
  367.  
  368.      GGGGDDDDTTTTXXXXLLLLUUUU
  369.           1 if texture lookup tables are functional, 0 if they are not.  (See
  370.           ttttlllluuuuttttddddeeeeffff.)
  371.  
  372.      GGGGDDDDTTTTXXXXSSSSHHHH
  373.           1 if TTTTXXXXSSSSHHHHAAAARRRR is functional, 0 if it is not.  (See tttteeeexxxxddddeeeeffff.)
  374.  
  375.      GGGGDDDDTTTTIIIIMMMMEEEE
  376.           Frequency of graphics timer events.
  377.  
  378.      GGGGDDDDTTTTRRRROOOODDDD
  379.           Maximum order of a trimming curve.
  380.  
  381.      GGGGDDDDWWWWSSSSYYYYSSSS
  382.           Type of window system running on the machine.  Returns GGGGDDDDWWWWSSSS4444SSSS if a
  383.           windowing system is currently running or GGGGDDDDWWWWSSSSNNNNOOOO if there is no
  384.           window system currently running.  Unlike most of the others, this
  385.           inquiry is independent of the currently selected screen.
  386.  
  387.      GGGGDDDDZZZZDDDDGGGGMMMM
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. ggggeeeettttggggddddeeee((((3333GGGG))))                                                          ggggeeeettttggggddddeeee((((3333GGGG))))
  401.  
  402.  
  403.  
  404.      GGGGDDDDZZZZDDDDPPPPXXXX
  405.           1 if routines that render geometry and routines that render pixels
  406.           (respectively) will do it into the z-buffer when zzzzddddrrrraaaawwww is .TRUE., 0
  407.           if they do not.
  408.  
  409. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  410.      gversi, scrnse
  411.  
  412. NNNNOOOOTTTTEEEESSSS
  413.      This routine is available only in immediate mode.
  414.  
  415.      To inquire about the screen on which the current window is displayed, use
  416.      the following sequence:
  417.  
  418.                integer*4 svscrn, dummy
  419.                ...
  420.                savescrn = scrnse(getwsc)
  421.                _v_a_l_1 = getgde(_i_n_q_u_i_r_y_1)
  422.                _v_a_l_2 = getgde(_i_n_q_u_i_r_y_2)
  423.                ...
  424.                dummy = scrnse(svscrn)
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.